home *** CD-ROM | disk | FTP | other *** search
/ PC go! 2008 August / PCgo 2008-08 (DVD).iso / interface / contents / onlineimuralub_6015 / 18845 / files / openvpn-2.0.9-gui-1.0.3-install.exe / OpenVPN GUI ReadMe.txt < prev    next >
Encoding:
Text File  |  2005-08-18  |  8.5 KB  |  232 lines
  1. Installation Instructions for OpenVPN GUI for Windows
  2. -----------------------------------------------------
  3.  
  4. You can either get my installation package for OpenVPN 2.0.X where I've
  5. bundled the gui in the installation package, or you can use the original
  6. installation package from OpenVPN, and then manually install OpenVPN GUI.
  7.  
  8.  
  9. Installation using the bundled OpenVPN package with OpenVPN GUI included
  10. ------------------------------------------------------------------------
  11.  
  12. * Download openvpn-2.0.X-gui-1.0.X-install.exe from 
  13.   http://openvpn.se
  14.  
  15. * If you have a previous version of OpenVPN GUI installed, shut it down.
  16.   Make sure it's closed by ALL logged on users.
  17.  
  18. * Run the install program. During the installation you can choose if the GUI
  19.   should be started automatically at system startup. The default is yes.
  20.  
  21. * Create a xxxx.ovpn config-file with your favorite texteditor and save it in:
  22.   C:\Program files\OpenVPN\config\. You should NOT use the "log" or "log-append"
  23.   options as OpenVPN GUI redirect the normal output to a log file itself. 
  24.   There is a sample config files in the "sample-config" folder. Please
  25.   refer to the OpenVPN project homepage for more information regarding 
  26.   creating the configuration file. http://openvpn.net/
  27.  
  28.  
  29. Manual installation of OpenVPN GUI
  30. ----------------------------------
  31.  
  32. * Download and install OpenVPN from http://openvpn.net/
  33.  
  34. * Download openvpn-gui-1.0.X.exe and save it in OpenVPN's bin folder.
  35.   Default is "C:\Program Files\OpenVPN\bin\". You must put it in this folder
  36.   because OpenVPN GUI depends on the OpenSSL DLLs installed in this folder by
  37.   OpenVPN.
  38.  
  39. * Create a xxxx.ovpn config-file with your favorite texteditor and save it in:
  40.   C:\Program files\OpenVPN\config\. You should NOT use the "log" or "log-append"
  41.   options as OpenVPN GUI redirect the normal output to a log file itself. 
  42.   There is a sample config files in the "sample-config" folder. Please
  43.   refer to the OpenVPN project homepage for more information regarding 
  44.   creating the configuration file. http://openvpn.net/
  45.  
  46. * Put a short-cut to openvpn-gui-1.0-X.exe in your 
  47.   "Start->All Program->StartUp" folder if you want the gui started automatically
  48.   when you logon to Windows.
  49.  
  50. * Start the GUI by double-clicking the openvpn-gui-1.0.X.exe file.
  51.  
  52. *** You need to be Administrator the first time you run OpenVPN GUI for it to
  53.     create its registry keys. After that you don't have to be administrator
  54.     just to run the GUI, however OpenVPN requires the user to be
  55.     administrator to run! ***
  56.  
  57.  
  58. Using OpenVPN GUI
  59. -----------------
  60.  
  61. When OpenVPN GUI is started your config folder (C:\Program Files\OpenVPN\config)
  62. will be scanned for .ovpn files, and an icon will be displayed in the taskbar's
  63. status area.
  64.  
  65. If you do not have any openvpn connection running, the config dir will be
  66. re-scanned for new config files every time you open the OpenVPN GUI menu by
  67. right-clicking the icon.
  68.  
  69. When you choose to connect to a site OpenVPN GUI will launch openvpn with
  70. the specified config file. If you use a passphrase protected key you will be
  71. prompted for the passphrase.
  72.  
  73. If you want OpenVPN GUI to start a connection automatically when it's started,
  74. you can use the --connect cmd-line option. You have to include the extention
  75. for the config file. Example:
  76.  
  77. openvpn-gui --connect office.ovpn
  78.  
  79.  
  80. Run OpenVPN GUI as a Non-Admin user
  81. -----------------------------------
  82.  
  83. OpenVPN currently does not work as a normal (non-admin) user. OpenVPN GUI
  84. 2.0 will solve this by using an enhanced version of the OpenVPN service
  85. to start and stop openvpn processes.
  86.  
  87. In the mean time, it is possible to use OpenVPN GUI to control the current
  88. OpenVPN Service to start and stop a connection.
  89.  
  90. To use OpenVPN GUI to control the OpenVPN service, set the registry value
  91. "service_only" to '1'. See the section about registry values below.
  92.  
  93. Limitations with this way:
  94.   
  95.   There is no way for OpenVPN GUI ta hand over a password to the service
  96.   wrapper, so you can't use passphrase protected private keys or 
  97.   username/password authentication.
  98.  
  99.   If you have multiple openvpn configurations, all will be started and
  100.   stopped at the same time.
  101.  
  102.   OpenVPN GUI is not able to retrieve any status info about the connections
  103.   from OpenVPN, so it will report connected as soon as the service is
  104.   started regarless of if OpenVPN has really succeded to connect or not.
  105.  
  106.   You cannot see the OpenVPN log in real-time.
  107.  
  108.  
  109. Run Connect/Disconnect/Preconnect Scripts
  110. -----------------------------------------
  111.  
  112. There are three diffrent scripts that OpenVPN GUI can execute to help
  113. with diffrent tasks like mapping network drives.
  114.  
  115. Preconnect  If a file named "xxx_pre.bat" exist in the config folder
  116.             where xxx is the same as your OpenVPN config file name,
  117.             this will be executed BEFORE the OpenVPN tunnel is established.
  118.  
  119. Connect     If a file named "xxx_up.bat" exist in the config folder
  120.             where xxx is the same as your OpenVPN config file name,
  121.             this will be executed AFTER the OpenVPN tunnel is established.
  122.  
  123. Disconnect  If a file named "xxx_down.bat" exist in the config folder
  124.             where xxx is the same as your OpenVPN config file name,
  125.             this will be executed BEFORE the OpenVPN tunnel is closed.
  126.  
  127.  
  128. Registry Values affecting the OpenVPN GUI operation
  129. ---------------------------------------------------
  130.  
  131. All OpenVPN GUI reg-values are located below the following key:
  132. HKEY_LOCAL_MACHINE\SOFTWARE\OpenVPN-GUI\
  133.  
  134. The follow keys are used to control the OpenVPN GUI
  135.  
  136. config_dir
  137.     configuration file directory, defaults to "C:\Program Files\OpenVPN\config"
  138.  
  139. config_ext
  140.     file extension on configuration files, defaults to "ovpn"
  141.  
  142. connectscript_timeout
  143.     Time in seconds to wait for the connect script to finish. If set to 0
  144.     the exitcode of the script is not checked.
  145.  
  146. disconnectscript_timeout
  147.     Time in seconds to wait for the disconnect script to finish. Must be a
  148.     value between 1-99.
  149.  
  150. preconnectscript_timeout
  151.     Time in seconds to wait for the preconnect script to finish. Must be a
  152.     value between 1-99.
  153.  
  154. exe_path
  155.     path to openvpn.exe, defaults to "C:\Program Files\OpenVPN\bin\openvpn.exe"
  156.  
  157. log_dir
  158.     log file directory, defaults to "C:\Program Files\OpenVPN\log"
  159.  
  160. log_append
  161.     if set to "0", the log file will be truncated every time you start a
  162.     connection. If set to "1", the log will be appended to the log file.
  163.   
  164. priority
  165.     the windows priority class for each instantiated OpenVPN process, 
  166.     can be one of:
  167.  
  168.         * "IDLE_PRIORITY_CLASS"
  169.         * "BELOW_NORMAL_PRIORITY_CLASS"
  170.         * "NORMAL_PRIORITY_CLASS" (default)
  171.         * "ABOVE_NORMAL_PRIORITY_CLASS"
  172.         * "HIGH_PRIORITY_CLASS"
  173.  
  174. allow_edit
  175.     If set to "1", the Edit config menu will be showed.
  176.  
  177. allow_password
  178.     If set to "1", the Change Password menu will be showed.
  179.  
  180. allow_proxy
  181.     If set to "1", the Proxy Settings menu will be showed.
  182.  
  183. allow_service
  184.     If set to "1", the Service control menu will be showed.
  185.  
  186. silent_connection
  187.     If set to "1", the status window with the OpenVPN log output will
  188.     not be showed while connecting.
  189.  
  190. service_only
  191.     If set to "1", OpenVPN GUI's normal "Connect" and "Disconnect"
  192.     actions are changed so they start/stop the OpenVPN service instead
  193.     of launching openvpn.exe directly.
  194.  
  195. show_balloon
  196.     If set to "0" - Never show any connected balloon.
  197.               "1" - Show balloon after initial connection is established.
  198.               "2" - Show balloon even after re-connects.
  199. log_viewer
  200.     The program used to view your log files, defaults to
  201.     "C:\windows\notepad.exe"
  202.  
  203. editor
  204.     The program used to edit your config files, defaults to
  205.     "C:\windows\notepad.exe"
  206.  
  207. passphrase_attempts
  208.     Number of attempts to enter the passphrase to allow. 
  209.  
  210. All these registry options is also available as cmd-line options.
  211. Use "openvpn-gui --help" for more info about cmd-line options.
  212.  
  213.  
  214. If you have any problem getting OpenVPN GUI to work you can reach me via
  215. email at mathias@nilings.se.
  216.  
  217.  
  218. Building OpenVPN GUI from source
  219. --------------------------------
  220.  
  221. * Download and install MinGW and MSYS from http://www.mingw.org/
  222.   I'm using MinGW-3.2.0-rc-3 and MSYS-1.0.10.
  223.  
  224. * Download and install the binary distribution of OpenSSL from
  225.   http://www.slproweb.com/products/Win32OpenSSL.html
  226.  
  227. * Download and extract the OpenVPN GUI source archive.
  228.  
  229. * Start a bash shell by running msys.bat.
  230.  
  231. * Run "make" from the OpenVPN GUI source directory. 
  232.